Table of Contents

   This Table of Contents retains the original printed manual page numbering scheme.  Special Tags have been added to allow instant Finding of all page references.  Pull down the File menu and Choose Find, then enter the desired page number with asterisk characters preceding and following the number.  
     For example, *7* will Find several tags that reside within the text formerly on printed page 7 of the manual.

Introduction
1

Presentation Conventions 
1

Chapter 1.  Prograph: The Language
3

Overview
3
Classes
4
Editor Actions
5
Class Names
5
Attributes
5
Methods
6
Plain Method
7
Get Method
7
Set Method
7
Initialization Method 
7
Methods
8
Universal Methods
8
Cases of Methods
8
Compact Code
9
Operations
9
Connectors
10
Datalinks
10
Synchro Links
10
Names of Operations
11
Prograph Operations
11
Simple
12
Constant
12
Match
13
Persistent
13
Instance
13
Get
14
Set
14
Super
15
Local
15
Evaluate
16
Name
16
Terminal
17
Root
17
Macintosh Toolbox Operations
17
Mac Method
17
Mac Constant, Mac Match, and Mac Global
17
Mac Get Field, Mac Set Field, and Mac Address
18
Multiplex Operations
18
Repeat
18
List
19
Loop
19
Partition
19
Controls
19
Success, Failure, and Error
20
Success
20
Failure
20
Error
20
The Controls
20
Next Case
21
Continue
21
Terminate
21
Finish
21
Fail
22
Inject
22
Persistents
23

Chapter 2.  The Editor Environment
25

General Rules in the Editor
25
Launching Prograph Documents
25
Prograph Extensions Folder
26
When Prograph Is Launched
26
Creating Prograph Elements
27
Automatic Scrolling
28
Selection
28
Appearance
28
Click
28
Shift-Click
29
Marquee
29
Dragging
29
Nudging
29
Zoom and Shrink-Wrap
29
Editing Names
30
Linking/Unlinking
30
Opening
30
Commenting
30
Manipulation of Groups of Selected Elements
30
Combinations
31
Error Prevention
31
Menu Descriptions
31
General Features
31
The Apple Menu
32
About Prograph…
32
Switch Context
32
Enter Editor
32
The File Menu
32
New
33
Open…
33
Save
35
Save As…
35
New Text…
36
Open Text…
36
Save Text
37
Save Text As…
37
Page Setup…
37
Print…
37
The Edit Menu
40
Undo
40
Cut, Copy, Paste, Clear
40
Cut Object
41
Copy Object
41
Paste Object
41
Delete Object
41
Replicate Object
41
Select All Objects
41
Copy Value
41
Replace Value
42
Propagate Attribute
42
Bring Closer
42
Send Further
42
The Tools Menu
42
Find…
43
Set Selection
45
Find Again
46
Replace
46
Replace All
46
Compact
46
Uncompact 
48
Make Execute Only
48
The Opers Menu
48
Simple 
49
Constant
49
Match
49
Persistent
49
Instance
49
Get
50
Set
50
Local
50
Evaluate
50
Mac Constant
50
Mac Match
50
Mac Global
50
Mac Address
50
Mac Get Field
51
Mac Set Field
51
Opers to Local
51
Local to Method…
51
The Controls Menu
53
Operations
53
Terminals and Roots
54
Controls on Operations and on the Output Bar
54
The Info Menu
55
Display of Information
56
Comment Visibility
64
Comment Propagation
64
Class Hierarchy
64
Errors / Program Correctness / Options
65
The Windows Menu
70
Universal Methods, Classes, Persistents
70
Methods…, Attributes…
70
Local Heritage…
70
Stack
71
Close Window
71
Remember Windows
71
Restore Windows
71
Tidy Icons
71
Add Scroll Page, Remove Scroll Page
72
Window Descriptions
72
The Universal Methods Window
72
Opening
73
Creating
73
Deleting
73
Naming
73
Editing a Method
73
Combinations
73
The Classes Window
74
Opening
74
Creating
74
Showing/Hiding Classes
74
Editing
75
Naming
76
Connecting / Disconnecting
76
Opening Classes
76
Combinations
76
Group Selection
76
The Class Methods Window
77
Opening
77
Creating 
77
Deleting
78
Naming
78
Transforming a Class Method
78
Editing a Method
78
Combinations
78
The Attributes Window
79
Opening
79
Attribute List Areas
79
Creating 
79
Deleting 
80
Editing
80
Naming
80
Commenting
80
Changing Default Values
80
Dragging
80
Combinations
81
Group selection
81
The Persistents Window
81
Opening
81
Creating
81
Naming
81
Changing Values
81
The Case Window
82
Banner
82
Opening
82
Creating 
83
Copying
83
Deleting
83
Naming
83
Specifying Execution Order
83
Connecting / Disconnecting
84
Commenting
84
Dragging
84
Transformations
84
Combinations of Creating, Connecting, and Annotating
89
Selection of Element Groups
90
Manipulation of Groups
90
Enforcement of Corresponding Arity
92
Propagation of Comments
92
Opening Operations: The Left and Right “Click Spots”
93
Manipulation of Cases
97
Case Controls 
97
Case List Pane
97
Closing Case Windows
98
Value Window
99
Banner
99
Window Regions
99
Opening
100
Modes
100
Editing
101
Effects of Buttons
102
Types
102
The Text Window
102
Opening
102
Naming
102
Editing in the Text Window
103
Effects of Context Switching
103

Chapter 3.  The Interpreter Environment
105

Modes of Execution
105
Windows
106
Stack Window
107
Opening
108
Actions
108
Rollback
108
Case Window
109
Opening
109
Actions
109
Displaying Values
110
Opening Value Windows
111
Rollback
112
Roll Forward
114
Effect of Roll Forward and Rollback on the Stack
114
Menus
114
Apple Menu
115
Switch Context
115
Enter Editor
115
Exec Menu
115
Run
116
Execute Method
116
Abort
116
Set Program
117
Clear Program
117
Step/Show Level…
117
Step/Show On, Step/Show Off
118
Breakpoint On
119
Breakpoint Off
119
Clear Steps & Breaks
119
Trace
119
Debug
119
Runtime Interruption
120
Automatic Creation at Runtime
120
Method
120
Attribute
121
Persistents 
121
Classes 
122
Errors in Execution
122
Apple Events
123
Prograph Interpreter Apple Events
123
Required Suite
123
Miscellaneous Standard Suite
123
Core Suite
123
Do Menu
124
Open Method Window
124
Close Window
124

Chapter 4.  Application Builder
125

General Features
125
Specification and WYSIWYG Editors
125
System 7 Look and Feel
127
Applicable Prograph Menus
127
Apple menu
127
About Prograph…
127
Enter Editor
128
Exit Editor
128
Edit menu 
128
Info Menu
129
Application Editor
129
Name
130
About Method
130
Classes
130
List of Instances
130
Windows/Menus
130
Library/Active List
131
>>New Instance>>
131
<<Set Defaults<<
131
Install
131
Add to Active List
131
Delete
131
Edit
132
Apple Events
132
Menu Editor
132
Menu
133
Disable Menu
133
Item
133
Method
133
Key
134
Balloon…
134
Insert Before
134
Insert After
134
Delete
134
Instance
134
Disable Item
134
Check
135
Styles
135
Keys
135
Bold, Italic, Underline, Outline, Shadow
135
Shift, Option, Control
135
Window Editors
136
WYSIWYG Window Editor
136
Window Specification Editor
137
Window Title
138
Activate Method, Close Method, Idle Method, 
Key Method
138
Document, Dialog, Plain, Plain w/Shadow
138
Close Box
138
Zoom Box
138
Grow Box
139
Modal
139
Window Item Editors
139
WYSIWYG Window Item Editor
139
Window Item
140
Click Item
141
Balloon…
141
Button
142
Radio Set
143
Check Box
143
Graphic
144
Pict
144
Icon
145
Text
146
Edit Text
148
Scroll Text
149
Styled Text in Prograph Classic
149
Scroll List
150
Canvas
151
Balloon Help
153
Balloon Help Editor
154
Access to Events
158
Events in Prograph
158
Apple Events
158
Handling Events Yourself
160
Mouse Techniques
163

INDEX            Use Contents Menu or Find *Index* to jump to the Index (last chapter)